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INTRODUCTION 


Tne MLC4&/5» a “soft™ version of the currant MLC is composed of a 
Single basercard and up to four quadsadaoter cards each capable 
of driving up to four datacomm lines. 3efore it is capable of 
griving a lines», each quadsadapter must be downloaded oy a program 
with the firmware necessary to rune In addition each of the four 
lines must de Loaded with the poroper configuration before it can 
rune This is aiso cone by a projram but after the firmware has 
been loaded to tne quad. 


Previously there were a numbder of adapters available for the “LC. 
These ran such disciplines as SYNC» ASYNC» TWOIr TELETYPE and 
BISYNC. In addition each adapter had a number of parameters 
Ctimeout values for example) which were set into tne adapter via 
hardware stravdse The Line configuration which is loaded to each 
line of a quadwadapter card serves to configure each tine to run 
a potentialiy different discipline as well as supply the values 
for what was oreviously entered via hardware straps on older 

adapters. | 


Therefore before the MLC4/5 can be used by software the firmware 
must be tLoaded into the quadctadapters and the aopropriate Line 
configurations must aiso oe toaded. This must be done after 
every clearv-start. in addition if while running the MLC4/5 has a 
parity error within at's firmware the firmware and aporonpriate 
Line configurations must be retoaded. Also if it 1s desired for 
a line of a quadsadapter to run.a discipline different from that 
which was originally toaded the alternate Line configuration must 
be Loaded to that tine of the adapter. . 


Included in the 10.0 release 1s a file "SYSTEM/NLFIRYWARE*. This 
contains the firmware to he toaded to a MLC4&/5 and one tine 


configuration named “"DJEFAULT"™. This configuration describes a 
Standard TROi Line configuration. This configuration may be used 
by the standard Network Controller released in 10.9 


WSYSTEM/TCONTROLLER"™. 


All datacomm programs which are to accass a MLCOC4/5 must ha 
capadle of toading the firmware and tine configurations to the 
MLC. A similiar routine has bean included in each of these 
programs to do the load and to doa reload when necessary. 
However all of these orograus will obtain their firmware and tine 
configurations from the standard system fila SYSTEM/MLF IRMWARE. 


: sh hi a gh km ze a a 
end 1 
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FILE SYSTEM/MLFIRMWARE 


The File SYSTEM/4LFIRMAARE is craated and modified only with the 
program SYSTEM/4LCLOADER. It contains both the firmware which 
must oe loaded to the quadmadanoters as well as what line 
configurations have oeen defined oy the user. The file 5s 
capable of containing 50 tine configurations. It however 
contains only one line configuration when released. 


The file is composed of a naeader record followed by the firmware 
which is inturn followed 5y the space to hold the line 
configurations.e The file is comnosed of one AREA» contains 99 
charactar records» bdiocked 390/29. 

The format of the header record is as fotlows: 


D1 HEADER FORMAT 


02 FILLER BIT(8)> 

O02 STARTING RECORD BIT(24)>» 
02 ENDING_RECORD | BIT(24)> 
O2 NEXT_AVAILABLE BIT(24)> 
O02 E£OF_PIJIINTER BITC24)» 
O02 FIRMWARE_EOF BIT(24)> 
92 LINE_FILE_SIZE BIT(24)>» 
02 FILLER 3IT(564)3 


The firmware in the file begins at record 1 and continues up ta 
aut not including the record number in FIRMWARE_EOF. 


LINE_FILE_SIZE contains tne number of records in the file. The 
first fours items in tne header record are used to’ delimit the 
confiqurations in the file. Tne configurations are stored in a 


doubly Linked List to which records are added and deleted by the 
program SYSTEM/MLCLOADER. The first configuration in the file is 
pointed to by STARTING_RECORD. Tne Last configuration in thre 
fiie is pointed to By ENDING_RECORD. Available entries in the 
file ar2 in a linked list» the start of which is pointed to by 


NEXT_AVAILAA@LE. The logical end of the file is pointed to by 
CUF POINTER. Available space past ENF_POINTER is used only when 
there is no snace in the available linked List. This 1s 


indicated when the value of NEXT_AVAILABLE ts equal to the value 
of EOF_POINTER alt snace up to EOF_POGINTER 1s full. The next 
configuration in the file goes at the position defined by 
EGF_POINTER and then both of the two values are bumped. 


REMUS Ne a ne eMC OM RECN 
rm 
r) 
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The format of each Line configuration record is: 


O01 LINE_FILE_STRUCTURE 


92 DEFINED BIT(3)> 
02 NEXT_RECIRD B31T(24)> 

92 LAST_RECORD 31T(24)> 

92 NAME CHARACTERC19)> 
02 CONFIGURATION 31T(552)> 

0? FILLER 311 (326)3 


DEFINED is non_zero if the record 1s active. NEXT_RECORD and 
LAST_RECURD are the Links for the Liste. NAME is the name of that 
configura atione CONFIGURATION is the actuat data which 1s to ae 
loaded to a tine of a quad adapter. It consists of a series of 
24 bit values» the first 3 bits being tne paraneter nunbers ithe 
last 15 oits Detng the parameter value. 


Ali configurations accessed by datacoam programs are don2 so oy 
the name of the configuration. The name of the configuration is 
defined within the program and at load time the file 
SYSTEM/MLFIRMWARE 385 opened anda search of the tinked List of 
entries performed to find the configuration of that name. 


The firmware tin the file 1s stored as a series of header and data 
records.e At least one data record must seoarate header records. 
A header record must be the first firmware record in the file. 
Alt firmware records ara stored in character form and are 
converted to hex before being Loaded to the quad adapter. 


Ali header records have an "H" jin column one and a four character 


numeric fietd columns six through nine. This field defines the 
address in the quad adapter where the following data is to be 
loaded. All data racords are delimited by "dad" characters the 
first of which must be in column six. If the entire record is 


filled with data the ending "3" wilt be in column 39. So no nore 
than 32 characters of data exist oer record. 
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PROGRAM SYSTEM/MLCLOADER 


The program SYSTeA/HLCLOADER is used to create and modify tha 
file SYSTEAM/MLFIRMNWARE. In tne inittal release of MLC4/5 it may 
also be used to implement the CCITT interface to the quad 
adapter. When running in a “*debug™ mode it may also be used to 
exercise the features of tne MLC4/5. 


When modifying the firmware file» inout to the program is via a 
remote file opened by the program. The CCITT interface is via 
O0T commands to the programe In its “debug™* mode inout may  ~0be 
Via either the remote file interface or the system ODOT. 


Operation of the program is controtled via settings of its 
SWitchese Four switches are used by the program: 


SWITCH OO: O = Default value» no action taken. 


1 - Initiate the DC/AUDIT interface at 894N time. A 
message wilt be dispiayed whan the file is opened. 
(This interface may be controlied via the systea 
ODT also.) 


SWITCH 1: Jj - Open the remote file. CNefault value) 


1 - Do not open the remote file. CALl input must he 
via the system ODT.) 


SWITCH 2: 0 Disable all “"deoug”®” functions. (Default value) 
i = Enaple “*debug™ mode 

SWITCH }: 0 = Default value» no action taken. 
i - Create the file SYSTEM/MLFIRMWARE and go to EQJ. 


These switcnes are checked only at 30J time. If modified tater 
they will be ignored. 


Since utilizing a remote file requires datacoum to be active in 
the system» the setting of SWITCH 1 will permit exercising thea 
MLC4/5 and modifying the CCITT settings of the quad adapter 
Without a datacomm system o281ng active. SYSTEM/MLCLOADER does 
it's own datacoam functions when either exercising the quad or 
changing the CCITT setings of the quad so when running itn this 
mode it onty may access a Line not being used by any other 
datacomm orogram. 


URC UN ECER Epa N AIMAt: ai tuneCoees Neen Reem mer Scat oe ha ceed 
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REMOTE FILE INTERFACE 


The following section descrides the commands entered to the 
program via the remote file interface. These are the commands 
which may d@2 used to nodify the file SYSTEM/SLFIRMWARE. There 
are additionat commands whicn inay entered througn the remote fila 
Interface. These are commands which exercise the MLC4/5 and are 
only permissablte whan the orogjram is running in it's “debug” 
mode. These will be descrioed tater in the section on "“deoug"™ 
commands. 


The name 0 f the remote file opened ‘dy the program 15 
"REMOTEMLC4". ft 15 a simple ramote file. The program 15 not an 
MCS. The progran interacts with only one station at a time. 


All input to the orogran via the remote | file interface is 
expected to oe In upper cas@e The only exception to this is when 
a NAME of a configuration is entered. The name may be any series 
of non blank characters. Alsca within the fields presented on the 
Various screens input may 02 free forme However imoedded blanks 
witnin tokens are not permitted. 


The SYSTEM/HLCLOADER*sS remote fite interface 1s designed to run 
strictly to a TO8&20/TD859/MT983 type device. it utilizes the 
various functions of these terminals and therefore running to any 
other tyne of remote device wilt give undefined results. Also 
since these terminals may b2 set up so that they do not go tnto 
LOCAL mode but stay in RCV mode it 18 necessary to prompt the 
program Cuse of the “"SPCFY™ key is recomended to prompt the 
program). In this way the program will not destroy previous 
messages to the screen by wnulttple mnessages since it 18 necessary 
prompt the program for additional outout. 


Please note: In tha examoles of outout from the program which 
follow» the "2?" characters are not present on the screens. These 
will apoear as forms characters at the terminal. Since these ara 
not printadle characters they appear here as "2?" characters. 


When the progran goes to 89J and ovens its remote file» the 
following screen is displayed at the terminal: 


PRESS "SPCFY™ NEXT TO OPTION DESIRED. 
CREATE LINE CONFIGURATION ~--r= 
CHANGE LINE CONFIGURATEIIN see" 
DELETE LING CONFIGURATION «r= 
PRIN? CONE LGURATIONS "=" 3<e=< 


Se UN erie ee G sae eines 


PO 0 OW 
OD 0 ord tg tng 


Except for tne recomaended method for prompting the programs this 
Screen 1s the onty one wher2a the use of the “SPCFY™ key 15 


expected. The "RET" key on the keyboard wiil skip the cursor 
through the ontions and the “"SPCFY™ key wilt indicate which 
option 1s to be done. The response by tne program will ba 


determined as a result of the antion requested. 


see cramer pit mune yng nigra Sort § ek rome acing ren amet “ett at romain Poems yer amt ne quae en” 
(a REG eG SO od re ed 
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CREATE LINE CONFIGURATION. 


The prograa will respond with the following screen: 


Ae. =.= s—6 ? ? NUMBER «<= 396 
BAUR ALE. Hee eS S= ? ? 
DISCIPLINE ese e 2 ? 
REC VES DELAY Sees ? 4 
TRANSULISDELAY “-s"" 7 ? 
INITIALS*TIMEQUT 2-2 ? ? 
TEXT* LIAEOU) === ? . 
SPURS tS. -SSseeeee+== ? ? 
VERTICAL@PARITY ----- ? 2? 
CAARAC IER SSL. Sees S> 2? ? 
CONTINUGUS*CARRIER eccee ? ? 
BCS: SSS eosesSe se ==4 5 ? ? 
PAD SSeS -ss<5.5 45 = - 2a 
TRANSPARENCY =2335-e=-e> ? ? 
DLACAMCOE Se es-=]<sseeee 2 2 
SWITCHED SS" =-ss== (ee 2 2 
BRE AK=ENAGLE. “Peres ss ece= 2° 2 
LUNG@“BREAN. See ees so se 2? 
PSEQVUUSCARRIZR“DETECT == 2-2? 
NEWSS TNC: e==>- Sea ae, le ST 
EQT=D15SCONVECL. @Se esse - 2 2 
Clit Sess Se4eee eee SSSe: 2 2 


The field "NUMBER w= 3596" indicates the record number in the 
file where the configuration will reside if correctly entered. 


The following vatues are oermissadle for each entry: 


NAME Any non blank field may be entered. It 
7 may be from 1 7 10 characters in length. 
If no name 15 entearedre the record numnbder 
with be used as tne name o f the 
configuration. 


BAUD“RATE Tne line speed of the configuration is 
’ to be entered. Speeds of 110 baud 
through 19»200 baud are permissable. 


DISCIPLINE Six disciolines are possible» "SYNC™s 
TASYNCT» “THOI*, "TTY"» KATeSYNC@E* 
CEBCDOIC BIeSYNC) and "BITSYNC*A™® CASCTT 
BI“SYNC). 


RECELTVE*ODELAY Any numeric value from 0 - 99959 may ba 
entered. This value is in milliseconds. 


EGAN ish er OOF ur hay cma, go ia the ale aA at nea hla a ali di cdl aaa a er er ta a pane tc meal hei ntl Het amannte etter 
a ws ie SPAR REN Renate : Ser UR pen aS PIR RR oe rit z 


BURRUUGHS CORPORATION 
COMPUTER SYSTEMS GROUP 
SANTA 3AR3ZARA PLATT 


TRANSMIT*OELAY 


INT TAL TT IMECUT 


TEXT*TiMEQutT 


STOP*3i TS 


VERTICAL “PARITY 


CHARACTER*SIZE 


CONTINUOQUS“CAKRTER 


BCS 


PAD 


TRANSPARENCY 


DIALWMODE 

SWITCHED 

SREAK@ENABLE 
LUNG*3RE AK 
PSEUDO“CARRIER@DETECT 
NEW*SYNC 
FOT*DISCONNECT 


CCLIT 


babs lik MIR Suey SPAS A ene Vin dnd ga liea ariel mbih no AS Hy death 
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Any nuneritc value from 0 = 99999 may be 
entered. This value is in milliseconds. 


Any numeric value from 0 = 99999 may bea 
entered. This value 15 in mitliseconds. 


Any numeric vatue from 0 7 99999 may be 
entered. This value is in millisecondse 


Values of O» i» 1.5 or 2 may be entered. 


Either "*NONE™, "000" or "EVEN" may bde 
entered. 


Either 5» 6» 7 or 3 may be entered. 


Either a *Y™ or "N*® may be entered if 
the option is desired. 


Either “NOVE™» "EVEN™s "ODD" or "CRC" 
may be entered. 


Fitner yt or "N™ may be entered 
depending on if the option is desired. 


Fither "¥" or “"N® may be entered 
deoending on if the option is desired. 


Either a "Y¥" or *N" may be entered. 
Eitner a “*Y™" or "N* may De entered. 
Either a "Y¥™ or "N”" may be entered. 
Either a “*Y¥™ or *"N" may be entered. 
Eitner a “Y" or *"N" may be entered. 
Either a *Y" or *"N™ may be entered. 
Either a "Y™" or "N"™ may be entered. 


Fither a “"*Y* or "N™ may be entered. 


it is advisable to refer to the MLC4/5 spec for the exact meaning 
of each of the above parameters. 


Please also note that the two CCiTT oparamaters SELECT*RATE and 


SELECT“STANCBY were not 
are valid paramatiers it 


included in the above List. While these 
iS @xpectedi that these two nparameters 


would be entered via different neans. 


orm atta ere i aorafi rre rea tiie matiimnicion eee tactelemmerettarrhtt tise + 


Sl 
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When enterinyz the configuration the screen should be transmitted 
from the HUME postition so that the antire screen may bea entered 
since the entire screen will be checked for validitty. 


The value of eachn paraneter will 92 checkad. In addition to tne 
value entered for each ograneterr two otner checks are done. it 
will mot be possiole to set noth the "DIAL@*MODE" and "NEW=SYNC" 
parameters or the "EQT*OISCINNECT* and "CCITT" psrameters in the 
Same configuration. , 


After antering the screen if no errors were detected the 
foilowing message witl oe returned: 


CONFIGURATION NUMBER <numoer> = <name> ACCEPTED. 
A prompt to the program will return the original menu again. 


Shouid any errors nave Deen detected they wittl be returned to the 
terminal. The configuration will not have been acceoted. It 
wilt have to be rewentered.» In addition to errors as a result of 
bad values entered» an error message will result if either the 
NAME entered nad been previously defined for another 
configuration or if tne firmware fite2 is full of configurations. 
In the latter case it witl be necessary to delete a configuration 
before another could be entered. 


An example of the three tyoes of error messages returned as well 
as the one warning possible is: 


CONFIGURATION NAME I5 NOT DEFINED = RECORD NUMBER WILL BE USED 
CONFIGURATION FILE FULL. 
A CONFIGURATION OF NAME <name> 1S ALREADY DEFINED. 
THe FULLOWING PARAMETERS WERE IN ERROR: 
BAUD@RATE 
CONTINUODUS@<CARRTIER 
PAD 


TRANSPARENCY 
OWLTCHED 
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CHANGE LINE CONFIGURATION. 


{f this ootion is specified the program wilt respond with the 
messaqe: 


ENTER CUNFIGURATION NAME = ? zs 


The user must then enter the name of a previously defined 
configuration. If not the following message wilt be returned. 


THAT CONFIGURATION IS NOT DEFINED. 
It will then be necessary to promot the orogram to have the 


originat manu returned. Tf avatid name 18S entered then that 
configuration will be returned in the following fora: 


TAA Sees aes ?DEF AULT 7 NUHBER w-7 393 
BAUR RAL 2 “SSeS Se - 2095097 
VP SCIPLive. “=ss> 2 TWO? 
RECEIVETULLAY S=s7= = 200090? 
TRANSMITT*DELAY s--- 290009? 


INTTIAL@TIMEQUT ---- 2935000? 
TEATOULMEUUT eeerer= 20005272 
SIPS a1 lS Ses Seema 2. le 
VERTICAL“ PARLIY: =e8e= Deven? 
CHARACVER@ SLL Ses eee: 7 ee 
CONTINUQUS@=CARRIER seeee ON? 


BCS seseces wenesnen- 2NONE? 
PAD ca*2---- eeeercesens= 2N? 
TRANSPARENCY scceceec--- 2N? 
DIAL“NCDE caer a<----- --- 2N? 
SWITCHED -oete----- once 2N? 
BREAK"ENABLE s2e"7-- se-- 2N? 
LONG“8REAK eocneen-n--- 2N? 
PSEUDO=*CARRIER@OETECT == 24? 
NEW"SYNC scarcer nen- s--- 2N? 
EQT“OISCONNECT =-2-2"-"- 2N? 
CCITT eacnenececn-=- so-- 2N? 


In this case also the screan snould be transmitted with the 


cursor in the hone position. 


The screen entered will be checked for validity just as when 
creating a new configuration. 


NOTE 3 When changing a configurations if the NAME of the 
configuration is changed» the result wilt be not to change the 
requested configuration but to create a new configuration» a 
mirror of the one reaquested to be changed Put with changes 
 apptied. in this it is a simple matter to create new tine 
configurations without having to anter alt the necessary 
parameterse 


pienso tient tees ier athst iterate inden 


ser iS et aa care tna ahah ety 


setter trtstetgr en 


saute stig 
3 F 
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Error massages returned when creating a tine configuration are 
capable of being returned nere also. 


If the screen was correctly eanterad the following nessage will be 
returned: 


CONFIGURATION NUMBER <numbar> = <name> changed. 


If the name of tne configuration was changed tne <numder> and 
<name> returned witt reflect that of the naw configuration. A 
promot will then be required to return tne original menu. 


DELETE LINE CONFIGURATION. 
If this ootion 18 requested tha program will respond with tha 
following message. 


ENTER CONFIGURATION NAME OR "ALL™ = ? ? 


If "ALL™ is not entered then the name witl be checked and an 
error returned if the configuration named 18s not defined (Ca 
prompt wilt then be necessary). 


If "™ALL”™ is entered then zach configuration will be returned to 
the screen ane at a time. If "ALL” 3s not entered then the 
configuration requested witli 9o.e returned. The configurations 
wilt not be automatically deleted. The terminal wilt be placed 
in forms mode with 2 "Y¥™" or "N” resoonse requirede The user must 
respond with either of thes2 two answerse Only a "¥* wili cause 
the configuration to pe deleted. If an invalid response 15 
entered then the following message is returned: 


INVALIO RESPONSE PLEASE ENTER "¥™" OR "N™. 


After a prompt the configuration will again be written to the 
screen. The format of the screen is: 


ooo causa on a 5 my ae Oo | ma enith gets oe 294 vabn nt reget ccienmenmeet sire presentment we teppei orbabye he 1 . 
Pacha ash aa Va a cals a eee get as ema tna er ee ta eer tes kiran hata ON UReN 


: Re ea Gz LASS RADAR acd oo cama in NE os a te omen he tram pistons 
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NAME. S2=== see Er AU NUMBER 2e- 393 

SAO RAT. === See > 99599 7 

DLSCLPLINE. -=<s= TWoOrL SHIULD THIS se DELETED 

RECETVESOELAY “S23. 00999 ENTER: YS ORO SN" 

TFRANKSMITeJELAY ==> 903990) 2? ? ” 

INTIITAG=TIMLOUT s==— 03000 

TEXTS TIMEQUT =<<=-e*% 9003? 

SI UP oli eee eee eases | 1 

Vent LeALaAraAni Tt. -S235 EVEN 

CHARACTER MS. ose ere 7 

CERTINUUUSR CARAT ER @===- ‘ 

BL S-esse= Sse eS NONE 

PRD S362 4423ss4seesee=0= N 

TRANSPARENCY =—=<<"<=- =e N 

GIALS ACO] sesso ees ere" +S ‘ 

SH ELERED = 3 <24=e 3443-322 N 

WREAR@W@ENAGLE See ee e= se CN 

LONG=SREAK ~SHee-s=+s-= N 

PSEVUDG*CARRIER*DETECT -- N 

NENSSING S2oSe=es==3= ase 

Pu. LoOCUNHel, =s2s2sss> N 

CCL. .-<s3 S246 S836 e5=% N 


After the delete has been oerformed» if “ALL” had Seen entered 
then the following message wiil be returned: 


FND DELETE <number> CUNFIGURATIONS DELETED. 
If a single name was supplied then the following 1s returned: 
CONFIGURATION NUMBER <numdar> CNOT] DELETED. 


A prompt will then be necessary. 


PRINT CONFIGURATIONS. 


This option allows the user to obtain a printed copy of the Line 
configurations in the firmware file. 


The inittal response to entering tnis option 1s similar to when a 
delete tine configuration in that the following message is 
returned. 


ENTER CONFIGURATION NAME OR *FALL™ = 2? | es 


If “ALL™ is entered then a copy of all tine configurations will 
be printed. Each configuration will 52 printed on a separate 
pag2 in a format identical to how Line configurations appear at 
the terminal. After tne configurations are printed the following 
message will be returned: 


€<numoer> RECORDS PRINTED. 
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If the name of a configuration is entered then after the name is 
checked for validity it will b2 printed and the followiny message 
returned to tne screen: 

RECURD NUMBER <numbder> = <name> PRINTED. 


After eitner of the above messayes tha orogran must ve prompted 
vefore the original menu will 52 returned. 


ODT INTERFACE 
When not running in debug node only six commands are possible: 
LOLGG 
STOP 
SET SELECT*STAND3SY ON <ppicctuu> 
RESET SELECTA*STANOBY ON <ppsec: uu 
ScT DATATRATE ON <onotecctuu> 
RESET DATATRATE ON <op2ccsuu> 
STOP wilf send the program to EOJ. 
TOLOQOG will either start or stoo0 auditing toa che DC/AUDIT.FILE 
depanding -on the previous state of the file. Either of the 
following message witl ba displayed: | 
TOLUG STARTED: <date> <tima> 
AUDIT FILE CLOSED AT <tima> ON <date>. 


if in trying to osen tne file anotner program was using the file 
the following message will be disptayed: 


"DC/AULCIT.FiLE™ LOCKED. 


The last four commands area used to modify the settings of the 
CCIiT?T oarameters within tha guad adapter. 


<ppicciuu> are tne Ports Channel and Unit Number of the Line of a 
quad adapter tv which the toad of the parameter is to be done. 
*s* characters must be oresent op» cc and uu fields may be ane or 
more characters. cc must be 0. uu must not be greater than 15. 
pp must not be greater than 3. 


if any of the above conaands were entered in error then the 
following message wiil ose disoiayad: 


INVALIC IONPUT COMMAND. 
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I f the tlatter four commands were entered without error the 
following nessag2 witl be displayed: 


COMMAND IN PROCESS. 
The loader routine within SYSTEM/ALCLOADER will then be called toa 
do tne load. Following the load one of the following messages 
witt be returned depenaing upon the result of the load: 

END COMMAND, NO ERROR DJDETECTEO. 

ADDRESS SPECIFIED If NOT A HiLC4/5. 

FIRMWARE LOAD NECESSARY. 

ERRGR DETECTED OURING CONFIGURATION LOAD. 
The meaning of th2 first two messages should be obdvious. The 
third indicated that a toad of the firmware must be done before 
the CCiTT options may be loaded. The last indicates that the 


load failed. This usually inolies that there is sone problea 


DEBUG MODE 


When SYSTEM/4ALCLOUADER t85 executed with SWiYTCH 2 = set to some 
non=zero value a numoer of additional commands will be possible. 
These commands may be antered througn either the renote file 


interface or through the OOT. “ith these commands it wiil be 
possible to drive the snecial functions of the MLC4/5. Loads of 
the firmwares as welt as toads and unloads of the _ tine 


configurations will be oossiot2. It is also possible to intearupt 
the quad adapter and raload the firmware and line configuration. 
Finally it is possible to exarcise the CCITT options of the quad 
adapter via the remote file intarface. | 


All of these dedug commands will cause the toader routine within 
the program to be accessed if the command was entered without 
error. If the conmand was entered via the ODT then the following 
message wilt be displayed oefora the loader routine is entered. 


COMMAND IN PROCESS. 
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Following the exit from the toader routine one of thirteen 
messages will D2 returned to aither tne OOT or the terminal these 
are: : 


END COMAAND» NO ERROR DETECTED. 

ADDRESS SPECIFIED IS NOT A ALC4/5. 

FILE "SYSTEM/MLFIRMWARE™ NOT PRESENT. 
ERXRGR CETECTE IN FIRMWARE. 

CONFIGURATICGN “<name>* 15 NOT OFF INED. 
ERRYUR DETECTED DURING FIRMWARE LOAD. 
ERROR DETECTED OURING CUNFIGURATION LOAD. 
FRRIUR CETECTED DURING UNLIAD. 

LOAD oF FIRMWARE NOT NECESSARY. 

LOAD OF CONFIGURATION NUT NECESSARY. 
FIRMWARE LOAD NECESSARY. 

ADAPTCR NOT PRESENT. 

INCOMPATIS3ILITY ERRUR DETECTED DURING START. 


It is not possible for atl of tnese errors to be returned with 
each command. 


in the case of running via tne remote file interface» the usual 


prompt must de entered after the result of the command has deen 


returned so that the original manu may oe given again. 
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REMOTE FILE INTERFACE 


In dedndug anode when the program goes to 39J/J and opens it's remote 
files tne following screen is disolayed at the terminal: 


PRESS “SPCFY" NEXT TO OPTION DESTREDO. 


CREATE LINE CONFIGURATION =---- ? ? 
CHANGE LINE CONFIGJRATIGN ----- 2 2 
DELETE LINE CONFIGURATION ----- 2? 
PRINT CONFIGURATIONS -oeee---e- ? 2 
STOP RUN s2eeceere- sialeiahatetateattates 2 2 
LOAD FIRMWARE se-2--"- eratesen 2? 
LOAD CONFIGURATION cecnneceee-- 2? 
FORCE LOAD FIRMWARE ccenerenne- 2 2 
FORCE LOAD CONFIGURATIIN ------ 73 
NOL LOA) sates ec ecr een ne ncennn ? 2 
UNLOAD CONFIGURATION s--------- 2 2 
SET/RESET SELECT“STANOBY ------ 2? 2 
SET/RESET ALTERNATE RATE s----- 2? 2 


The first five options have been described oreviously. 


LOAD FIRMWARE. / FORCE LOAD FIRMWARE. / UNLOAD CONFIGURATION. 


While these commands performn se@nerate functions their format is 
simitiar. | 


The firmware in the firmware file wilt be tLoaded with the first 
commande It witkl be dane onty if the quad adapter indicates that 
a load of the firmware is necessary. The second command will 
also toad the firmware to the quad adapter but will do $9 
regardless of wether the firmware has been oreviously Loaded. It 
Will interrupt the quad adanter and force a reload of the 


firmwaree The tnird conmnand ail unload the current 
configuration fron the quad éedanter and disolay the result on tha 
screene It wilt pe necessary for the firmware to have bean 


previously loaded for this command to not raturn an errore 


When this command is reguested the orogjgram will resoond with the 
messages 


ENTER HARDWARE ALORESS 3° PPSCCsAA 
? 3 >: 6? 

It is expected that two numeric characters for each field be 

entered. The "3" characters ara required. The fields entered 

Will bs checked for validity and if an error was datected then 

the following message is returned: 


ADDRESS ENTERED IS INVALID. 
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Thase commanas will terminat2 as described above. Yowever in the 
case of the %YUNLGAD cotmana additional data will be returned to 
the terminal. A page of output sinilar to those usually returned 
to the screen will oe delivered. It wilt contain a description 
of the current Line configuration within the quad adapter. tt 
Will also contain the settings of the CCITT parameters within the 
Guad adapter. A sample screan would be: 


BAYITRATE stenecece-- 09500 
DISCIPLINE =---- TWDT 
RECELVESDELAY seeee= 99999 
TRANSMIT“OELAY <-> 00009 


LNT TPAR@LIAECGUT s="— 93709 | 
TEAPTATINE GUT Seeeer’ 00032 


STOP A3ITS crerceree--- 1 
VERTICAL“PARITY ---2-- EVEN 
CHARACTER*SIZE s2eecn--- 7 
CONTINUOUS=CARRIER 7---- 
BCS tose ceen-- eacece= | NONE 
PAD sc22%2--- weecerceen- 
TRANSPARENCY =---- s----- 

DIAL“MOQDE s------- ------ 


N 
N 
SHITCHED =-s-*------- se 4 
BREAK@ENAGLE srecentern= 
LONG@3REAK sseneseseene= y 
PSEUCO-CARRIER=DETECT == N 
NEW=SYNC snceerereceens= 
EQT“DISCONNECT =-"---e--- N 
CCITT werecccccennsse--- 
SELECTCRATE teseecsss--- ON 
SELECT“STANDBY cccerere=  N 


LOAD CONFIGURATION. / FORCE LOAD CONFIGURATION. / NDL LOAD- 


The action of these three cormmanids is also different but the 
input to the commands is similar. 

The first command wiitl cause a line configuration to be Loaded to 
the quad adapter. In order for this to be done the firmware must 
have 322n previousty loaded to the quad adanter and the quad must 


Indicate that a configuration has yet to be loaded. The second 
command will interrupt the quad adapter and force a reload of 
bath the firmware and tne named line configuratione Tne third 
command will access the quad adapter in a manner simitar to the 
way NOL accesses ite it will examine the state of the quad 
adapter and toad the firmware to it only if the quad indicates 
that 3a toad of the firmware 16 neaecessarye It witl then always 


toad the line configuration to the quad reyardless of wether a 
configuration had been oraviously loaded or note 


Foilowing the request for either of these commands» a hardware 


address must de entered just as in tne case of the above three 


commandse The means for entering tne address is identicai toa 
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that for th2 above conmands. The same error message may result. 


After the address 18 entered it will oe necessary to enter the 
nama of the Line configuration which 1s to De Loaded to-the quad 
adapter. The following message is returned to the screen: 


ENTER CONFIGURATION NAYE = ? 2 


The firmware file will be scanned for a configuration which 
match2s thea name which the user entered. {If no matcn was founds 
tne following error will be returned: 


THAT CONFIGURATION IS NOT JEFINED. 
A prompt would tnen de required to return the ortginal menu. 


if a match was found the toader routine wilt be called as 
descrio02d apoves 


SET/RESET SELECT“STANDBY.j / SET/RESET SELECT“RATE. 


The use and action of these commands is simttlar. They are used 
to set and reset the CCITT functions of the quad. 


Both of these commands require the address of the quad adaotear 
which is to be accessed to be entered. The manner for entering 
tne address 1s identical to that for the above six commands with 
the same results. 


Whichever of the comaands were entereds the program then responds 
with the message: 


AHICH OPTION? CUSE "SPOFY™ KEY.) 
SET OPTION -e--e--- laiatatatebtetatatate 
RESET OPTION seere rere eennecen- 


63 843 


649 0s) 


This 1s the onty other portion of input to the program where the 
"SeCry¥” key 18S exdected to de used. [If the "SPCFY" key is not 
used or used from outside the forms fields then the fottowing 
message will be returned: 


ERROR: INVALID COMMAND. 
Tne usuat prompt returns the original menu. 


If th2 option 15 entered correctly then the toader routine is 
entered with the results descrihed above. 
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ODT INTERFACE 


Five "debug™ commands are possibie through the COT. ALl require 
the address of a quad adapter to oe antered. Three commands 


require the name of a coafiguration to de supplied also. The 


formats of these comaands are: 
LOAD FIkKMWARE TO <optcetuu> 
FORCE LOAD FIRMWARE TJ <nptcctuu> 
L JAD CONFIGURATION <name> TD <optcceuu> 
FORCE LOAD CONFIGURATION <nane> TQ <ppecciuu> 
NOL LOAD <name> TO <ppteciuu> 
These comnands may be aboreviated» their format then being: 
LF <optcczaa> 
FF <name> <opicciaa> 
LO <name> <pn:rcciaa>m 
FO <name> <ppscctiaa> 
Nl <name> <potcctaa> 


For the conmands to be valid tne <name> field must de tne name of 
a previously defined lire configuration. 


The tnrea portions of the hardware address must be numeric of any 
length. The values of the three fields witt be checked “(for 
validity. fhe "3" characters are mandatory. 


ae het pea inte yt inramentaicst treet 
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The action of these commands 15 
Via the renote file interface. 

to tha quad but do so only if 
The second will load firmware to 
of tne quad. 
firmware reloaded. Thea 

configuration to the quad. 
nag firmware toadegd to itt and is 
fourth command 


line confiytration rejardtess of the state af the quad 
Interruot the guad and retoad both. 


it will 
duplicates the toading nathod of 
check tne auad and 


indicates that a ioagd is nacessary. 
regardless of wether the quad indicates 
In this way NOL is assured that it 15 


tne line configuration 
one 31S nece2ssary or not. 
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Similar to those defined for use 
Tne first wttltl load the firaware 
the quad is in need of firmware. 
the quad ragardiess of the state 


It will cause the quad to Se interrupted and the 
third 
It will do so only if the quad has 


coamand witl toad a Line 


in need of a configuration. The 


wiid force aratoad of both the firmware and thea 


adapter. 
The tast command 
the quad used by NOL. It will 


Load the firmware only if the quad adaoter 


It will however always toad 


running the correct configuration for it's needs. 
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CHANGES TO NOL 


There have been many changes to NOL in order to support the 
MLC4G/D. These include a routine to toad the firmware and tine 
configurations tne quad adaoters» code to sanse the presence of a 
MLC4/5 at open time and do tne toad and code to do ae reload 
whenever a parity error within the quad adapter ts detected. 
Changes nave also seen meade to tha NOL microcode witnin the SdL 
interoreter. Tnes2 are cnanges to sanse that a parity error has 
occurred within the quad adapter and to report this to the 
network controller so that it may do a retoad. 


There is onty one change as far as the user 1s concerned. A new 
Statement nas been defined in NOL syntax. When defining a LINE 
in an NSt- program an additional tine of code is possible to 
define tne name of the line confijguration which is to be Loaded 
to the ALC4/5./ The syntax is: 


CONFIGURATION = <Configuration Name>. 


The statement 1s onty tleagat when defining a line in the NOL 
compile. 


NDL/DUMP and NIF/SANALYZER have hoth been changed to reflect tha 
presence of a COAFIGURATION within a Line definition. 


If a Configuration has deen defined for Line it will de assumed 
py the resultant network controller that Line 1s on a MLEOG/5. ft 
will attempt to toad tne firmware to tnat Line Cif the quad 
adaoter indicates that a firmware load 115 required) and witt 
aiways toad the configuration of the name defined in the 
CONFIGURATION statement in the NOL compile for that tine. The 
network controtier will do this whenever an OPEN is baing 
processed for atine on a 4YLT4/5 which was previously inactive. 


It should oe noted that the configuration defined within the NOL 
compile mnust hava? been defined within the file SYSTEM/MLFE TRMWARE 
or elise the attemoted Load by the network controller wilt fail 
Since the configuration is undefined. This wilt be reflected by 
the fact that the open will bse danied with the reason that the 
adapter 35 miSSiNg.- Prior to baing down Loaded the guad adapter 
responds to a TEST op with an 1D indicating that no hardware 15 
prasent. Shouid the toad fail th2 hardware will indeed appear as 
if no nardware is present and hence the OPEN +s dented for that 
reason. If a no configuration is specified in the comoile for a 
line which i185 on a MLO4/5 tne OPEN witl also fail for the sama 
reason since no toad wilt ever he attempted oy the network 
controiler. 
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If a configuration is defined in the NDBL coapilt?2 for a tine which 
is not on a ALC4/5. The Lina will still run oroperty. Prior to 
doing a load the toader routine within tha network controller 
will verify that the address of tne Line 1s indeed that of a 
MLC4G/5. If tt 15 not it wilt not do the load. 


There is some overnead within the network controller if any tine 


1s to access a MLC4/5. 18299) bits of additional value stack 
Soace are required by the network controtler to cail it's routine 
to toad the firmware and line configuration. If no tine 


at 


configurations are defined in the NOL compile this memory will 
not be added to the retwork controllers value stack since the 
loader routine witl never oa calied. 


Finally it should be noted that the initial release of NDL to 
suoport the MLCO4/5 will aot atlow the user to use the AUTODIAL 
feature in HDL when accessing a WLC4/5. VDiatout 11s nandled 
differently on this ALC. Plans are to include this feature in 
the 11.0 ralease. | 
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CURRENT CCITT INTERFACE 


The initial release of NIL to supoort the MLC4/5 wiil not sunport 


the CCiftT interface of the MLC. These are the ability to set 
SELECT@*STANDSY and SELECT“*RATE for tines on the quad adapter. Ona 
the previous ALC these were set via switches on the adapter. Qn 
the MLC4/5 these must b2 set/freset via a special load to the quad 
adapter. Chanjes to NOL to support these options are scheduled 
for the 11.9 release. For tne initial release these must be done 
via the program SYSTEM/ALCLOADER. As mentioned above ODT 
commands to the program have bh2en defined to do the tLoad. tt 
would oe advisadle to execute SYSTEM/H¥LCLUADER so that it doas 
not open it's remote file when doing thise Also when doing this 
it will be necessary to nave no other data comm program using the 
Line which SYSTEM/HAHLCLOAVER 18 to access. So 3f the tine 15s 


active within the network controller it will be necessary to do a 
RELEASE LINE before executing the Loader orogram. 
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CHANGE LINE CONFIGURATION. 375 
CHANGES TO NDL 4-1 

CREATE LINE CONFIGURATION. ag 
CURRENT CCITT INTERFACE P hae | 


GEdUG MODE 5710 
DELETE LINE CONFIGURATION. 527 


FILE SYSTEM/MLFIRANARE daa | 
INTROOQUCTION ot \ 


LOAD CONFIGURATION. / FORCE LOAD CONFIGURATION. / NOL LOAD. S215 
LOAD FIRMWARE. / FORTE LOAD FIRMWARE. / UNLCAD CONFIGURATION. $=" 12 


UOT INTERFACE $79% 3715 


PRINT CONFICURATTONS. 525 
PROGRAM SYSTEM/MLCLOADER 3-1 


REMOTE FILE INTERFACE SA Ce- 312 


fr 
ry 


SET/ZRESET SELECT*STANDSY. / SET/RESET SELECT@RATE 3714 


